package com.competition.commgr.service;

import java.util.List;
import java.util.Map;

import com.competition.commgr.domain.Award;
import org.springframework.web.multipart.MultipartFile;

/**
 * 获奖记录Service接口
 */
public interface IAwardService
{
    /**
     * 查询获奖记录
     *
     * @param awardId 获奖记录主键
     * @return 获奖记录
     */
    public Award selectAwardByAwardId(Long awardId);

    /**
     * 查询获奖记录列表
     *
     * @param award 获奖记录
     * @return 获奖记录集合
     */
    public List<Award> selectAwardList(Award award);

    /**
     * 新增获奖记录
     *
     * @param award 获奖记录
     * @return 结果
     */
    public int insertAward(Award award);

    /**
     * 修改获奖记录
     *
     * @param award 获奖记录
     * @return 结果
     */
    public int updateAward(Award award);

    /**
     * 批量删除获奖记录
     *
     * @param awardIds 需要删除的获奖记录主键集合
     * @return 结果
     */
    public int deleteAwardByAwardIds(Long[] awardIds);

    /**
     * 删除获奖记录信息
     *
     * @param awardId 获奖记录主键
     * @return 结果
     */
    public int deleteAwardByAwardId(Long awardId);

    // ============== 新增方法 ==============

    /**
     * 获取已审核的培训中心报名数
     * @param teamId 团队ID
     * @return 返回数
     */
    public int getApprovedTrainingCenterRegistrations(Long teamId);

    /**
     * 检查团队成员身份
     *
     * @param userId 用户ID
     * @param teamId 团队ID
     * @return 是否是团队成员
     */
    public boolean checkTeamMembership(Long userId, Long teamId);

    /**
     * 获取用户有权限的团队列表
     *
     * @param userId 用户ID
     * @return 团队列表
     */
    public List<Award> selectUserTeams(Long userId);

    /**
     * 根据团队ID获取关联的赛事信息
     *
     * @param teamId 团队ID
     * @return 获奖记录（包含赛事信息）
     */
    public Award selectCompetitionInfoByTeamId(Long teamId);

    /**
     * 调试用户团队数据
     */
    List<?> debugUserTeamsDetail(Long userId);

    // ============== 新增获奖上报相关方法 ==============

    /**
     * 上报获奖记录（带文件上传）
     *
     * @param sessionId 比赛届次ID
     * @param teamId 团队ID
     * @param level 获奖等级（文本）
     * @param certificateFile 证书文件
     * @param operName 操作人
     * @return 结果
     */
    public int reportAward(Long sessionId, Long teamId, String level, MultipartFile certificateFile, String operName);

    /**
     * 修改获奖记录（带文件上传）
     *
     * @param awardId 获奖记录ID
     * @param sessionId 比赛届次ID
     * @param teamId 团队ID
     * @param level 获奖等级（文本）
     * @param certificateFile 证书文件
     * @param operName 操作人
     * @return 结果
     */
    public int updateAwardWithFile(Long awardId, Long sessionId, Long teamId, String level, MultipartFile certificateFile, String operName);

    /**
     * 检查用户是否有权限上报该团队获奖
     *
     * @param userId 用户ID
     * @param teamId 团队ID
     * @return 是否有权限
     */
    public boolean checkAwardPermission(Long userId, Long teamId);

    /**
     * 获取用户的所有团队（包括调试信息）
     *
     * @param userId 用户ID
     * @return 团队列表
     */
    public List<Map<String, Object>> getAllUserTeams(Long userId);

    /**
     * 获取有效的用户团队（通过审核的团队）
     *
     * @param userId 用户ID
     * @return 有效的团队列表
     */
    public List<Map<String, Object>> getValidUserTeams(Long userId);
}